home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / tdown10.zip / TAKEDOWN.DOC < prev    next >
Text File  |  1992-08-11  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   TakeDown 1.0
  8.                              A BBS Node TakerDowner
  9.                       Copyright (c) 1992 By Mark D. Goodwin
  10.                       -------------------------------------
  11.  
  12.      TakeDown is a copyrighted program that is distributed on the shareware
  13.      basis.  The  registration fee for registered TriBBS  sysops and TriBBS
  14.      sysops  still  in  their  30  day   evaluation  period  is  $0.    The
  15.      registration fee for  sysops who run any other type of BBS software is
  16.      $5.   Registrations should be  sent to:  Mark Goodwin,  366 14th  St.,
  17.      Bangor, ME 04401.
  18.  
  19.  
  20.      WHAT TAKEDOWN DOES
  21.      ------------------
  22.  
  23.      On a multinode  BBS, there are many  times when you want  to take down
  24.      the whole  system during  an event in  order to perform  an operation,
  25.      such as  message base packing, that  could cause damage to  your BBS's
  26.      data files if the  operation was performed when one or  more BBS nodes
  27.      are still up and  running.  If your BBS  software, such as TriBBS,  is
  28.      capable  of each  node  running  its own  events,  TakeDown will  make
  29.      bringing a whole system down  a very easy process.   Additionally, any
  30.      nodes  brought  down by  TakeDown will  not  be brought  up  until the
  31.      desired event has completed its task.
  32.  
  33.  
  34.      HOW TAKEDOWN WORKS
  35.      ------------------
  36.  
  37.      TakeDown performs  this rather  nifty feat by  simply creating  a zero
  38.      byte file (a  dummy file whose length is 0 bytes).  After creating the
  39.      zero byte file,  TakeDown will check once  every 15 seconds to  see if
  40.      the file  still exists.    If the  file  still exists,  TakeDown  will
  41.      continue monitoring the file's status.  Otherwise, TakeDown will  stop
  42.      running and return control back to  the event batch file that executed
  43.      it.
  44.  
  45.  
  46.      AN EXAMPLE
  47.      ----------
  48.  
  49.      Let's suppose you have  a three node system and you  want to pack your
  50.      message base using  a node 1  event that's scheduled  for 00:01.   The
  51.      first thing you  would want to do  is set up events for  the other two
  52.      nodes that will run a few minutes before the node 1 event.  So for our
  53.      example you would set up events for  both nodes that would be executed
  54.      at 23:58.  The node 2 batch file would appear as follows:
  55.  
  56.      takedown node2.dwn
  57.  
  58.  
  59.      Yes, that one line batch file is all you need.  This tells TakeDown to
  60.      create  a  file  called   NODE2.DWN  in  the  current  directory   and
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      continuously loop as long as the file exists.  NOTE: Your  event batch
  74.      file may need an additional line  to restart the BBS.  For  example, a
  75.      TriBBS board would need a line  that contains BOARD.BAT to restart the
  76.      BBS software.
  77.  
  78.      The event batch file for node 3 would be similar to node 2's:
  79.  
  80.      takedown node3.dwn
  81.  
  82.      The batch  file for node  1 would be  a little more complex,  but it's
  83.      still pretty simple:
  84.  
  85.      if not exist \node2\node2.dwn goto end
  86.      if not exist \node3\node3.dwn goto end
  87.      tripack /p
  88.      :end
  89.      del \node2\node2.dwn
  90.      del \node3\node3.dwn
  91.  
  92.      Let's examine the above batch file a line at a time:
  93.  
  94.      if not exist \node2\node2.dwn goto end
  95.  
  96.           The above line checks to see if TakeDown successfully created its
  97.           zero byte file for node 2.   Note that this assumes that node 2's
  98.           main  directory is NODE2.   If the zero  byte file doesn't exist,
  99.           the batch file  will abort the event by branching to the label at
  100.           the "end" of the batch file.
  101.  
  102.      if not exist \node3\node3.dwn goto end
  103.  
  104.           The above line checks to see if TakeDown successfully created its
  105.           zero byte file for node 3.  Note  that this assumes that node 3's
  106.           main directory  is NODE3.  If  the zero byte  file doesn't exist,
  107.           the batch file will abort the event  by branching to the label at
  108.           the "end" of the batch file.
  109.  
  110.      tripack /p
  111.  
  112.           The above line  packs a TriBBS BBS's message base.  Obviously you
  113.           can put anything else at this point in the event file.
  114.  
  115.      :end
  116.  
  117.           The  above line  is simply a  label that  the batch file  uses to
  118.           abort if  TakeDown wasn't  successfully run by  either Node  2 or
  119.           Node 3.
  120.  
  121.      del \node2\node2.dwn
  122.  
  123.           The above  line deletes  node 2's zero  byte file and  will cause
  124.           TakeDown to stop running within 15 seconds.
  125.  
  126.      del \node3\node3.dwn
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           The  above line  deletes node 3's  zero byte file  and will cause
  140.           TakeDown to stop running within 15 seconds.
  141.  
  142.  
  143.  
  144.      YOUR AUTOEXEC.BAT FILE
  145.      ----------------------
  146.  
  147.      It is probably  a good idea to have commands in your AUTOEXEC.BAT file
  148.      that will  delete any zero  byte files that you  have TakeDown create.
  149.      If your system crashes during an event, the zero byte files may not be
  150.      removed properly  and TakeDown will  abort whenever it finds  that the
  151.      zero byte file  it is supposed to create  already exists.  This  is to
  152.      prevent overwriting existing files by accident.
  153.  
  154.  
  155.      SUPPORT
  156.      -------
  157.  
  158.      Support can be  obtained for TakeDown by  calling The Lobster Buoy  at
  159.      207-941-0805 (V.32bis) or 207-945-9346 (HST/V.32bis).  Additionally, I
  160.      can be reached on FidoNet at 1:328/104, on RelayNet at LOBSTER, and on
  161.      Intelec.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.